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: : WARNING : : 


COPYING THE ALOG DISFLAYMAKFER DISK 


The ALOG DISPLAYMAKER program disk is not copy-protected 
and you may make copies ( for your own use only, please ' ). To avoid 
the inconvenience of swapping disks, display screens can be stored on 
the program disk. This creates the possibility of some error that 
might wipe out the program itself. WE THUS STRONGLY SUGGEST THAT YoU 
IMMEDIATELY COPY THE PROGRAM DISK AND USE ONLY THE WORKING COPY FOR 
STORING DISPLAY SCREENS. Note that the ATARI DOS disk copy routines 
will copy your original disk, but you may have trouble making copies 
of copies ! 


THE ALOG DISPLAYMAKER 


The ALOG DISPLAYMAKER is a utility program designed to help 
the user create high resolution displays on a monitor or television 
set being driven by an ATARI computer. The program enables one to 
both generate geometric figures (e.g. lines, circles, rectangles,etc.) 
and to easily type various characters at arbitrary locations on the 
screen. Characters can include the standard alphabet, in lower or 
upper case (including inverse letters and three letter sizes), as 
well as any special characters the user may wish to create (using the 
built-in character editor). Four colors can be displayed at one time, 
and each of these colors can be chosen using a visual display of all 
128 colors available on the Atari. Display resolution is 160 x 160. 
All displays can be saved on disk, or printed in two sizes on an 
(optional) Epson MX-80 printer with graphics options. Displays can 
also be shown sequentially in a" slide show " format. 


This program has many potential uses. Both children and 
adults may find it just plain fun to create colorful “works-of-art". 
The ALOG DISPLAY-MAKER can also be used for preparing computer 
"slides" for educational or business purposes. These slides can be 
re-created from disk storage or duplicated photographically with an 
ordinary 35 mm camera. Full or quarter page print-outs can also be 
made with an Epson MxX-80 printer and used in reports or made into 
overhead transparencies. 


| SUMMARY OF FEATURES 
Graphics Mode: 


"Rubberband" line drawing 

Joystick controlled drawing 

Adjustable ellipse drawing (includes circles) 
Rectangle drawing 

Semi-automatic Fill 

EFasy color manipulation 

"Zoom" magnification for details 

"Slide Show" display presentations 


Character mode (Text Input) 


Three different character sizes 
Three different colors 
Ability to mix colors, sizes, and place characters anywhere 
Includes upper case, lower case, and inverse video 
Extra character set with Greek letters 
xk "Built-in" character editor % 
¢ Add any character you wish without interrupting program ) 


General 
Program disk copyable 
Store displays on program disk 
Copy display on graphics printer 
(includes a double size option that fills standard 8 i/2 x 11 page) 


( ATARI is a trademark of ATARI, Inc. ) 
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REQUIRED EQUIPMENT 


ATART 400 or 800 Computer 
48k af RAM 
Une disk drive 
Joystick (aptional ) 
Printer with dot graphics capability (e.g. Epson with Graftrax, 
Prowriter,etc. ) 
{used to print capies of displays) 


LOADING THE ALOG DISPLAYMAKER 
i. Remove all cartridges from your computer and turn computer off. 
2. {urn on your disk drive. 


4. When the disk drive is ready, insert the ALOG DISFPLAYMAKER program 
disk. 


4. Turn on your computer and TV set or monitor. 


3. The program will begin to load automatically. When loading is 
completed, you will first see a title screen. This will 
disappear in a few seconds and you will then see —_ 
a cross-hair type cursor centered on the screen and a 
text window at the hottom containing a command summary. 


AN INTRODUCTORY SLIDE SHOW 


One of the special features of the ALOG DISPLAYMAKER is the 
ability to present a "slide show" of previously created displays. The 
Original program disk contains eight such “slides” that can be used 
to show the various features of the ALOG DISFPLAYMAKER. To exhibit 
these displays, press the <X> key. You will first be given some 
preliminary instructions. You can then view the introductory screens 
by simply pressing the <1> - <8> keys. Press the <RETURN> key when 
finished tao return to the main program. 


Any displays you create can be shown in a similar manner 
qgice they have been saved on disk. In fact, you can prepare an 
art show, business presentation, aor briefing using one or more disks 
and this "slide show " feature. 


A BRIEF JOURNEY THROUGH THE ALOG DISPLAYMAKER 


The ALOG DISPLAYMAKER is made up of two seperate 
sub-programs which will be referred to as the GRAPHICS MODE and the 
TEX! ¢ or character )> MODE. The program is in the graphics mode 
immediately after being loaded. This mode can be identified by the 
commands shown in the text window. The first line of this window 
shows: : 


aieines <Doraw <E>llipse <F*2ill 


The currently active command is shown in inverse video. ( <L>ines 
should be ain inverse video when the program is first loaded. ) The 
single key indicated by <key> is used to select other commands. ( Try 
hitting the <D>, <E>, or <F> keys. ). The present color ¢( indicated 
by <O7, <1, <22, or <3> ) is alsa shown in inverse video. 


Note that mast commands in the graphics mode are controlled 
using the joystick ¢ plugged into port #1 ). The keyboard may be used 
instead of the joystick by using the arrow keys to move the cursor 
and the pressing space bar instead of the fire button. Note that 
keyboard response is slower than that of the joystick, making it ideal 
for cases where fine positioning is needed. 


ELeines 


While in the <«L>ines mode, try moving the screen cursor 
around with the joystick ( or the keyboard arrow keys ). Pick a 
location where you want a line to start and press the fire button on 
the joystick ( or the space bar on the keyboard ). Now move the 
cursor away fron the starting spot. You should see one cursor remain 
in the spot marked and another moving with the joystick. A flickering 
line will be shown between the two cursors. When the moving cursor is 
where you want the line to end, simply hit the fire button once more 
to "fix" the end point of the line. A permanent line will then appear 
on the screen. This type of line drawing is known as “rubber—band" 
graphics because the line is stretched like a rubber-band from the 
starting point to the moving cursor until put in-place with the fire 
button. You can then move the cursor to any location, hit the fire 
button to fix the starting location, and begin the entire pracess 
once again. You can change the color of the line being drawn at any 
time by hitting the color number keys, <0>-<3>. ( Note that <O>} is 
the background color. Lines drawn with color <0O> may thus be 
invisible. ) 


<D>raw and <Z>oom 


In the <D>raw mode the cursor acts like a paint brush which 
only “draws" on the screen when the fire button is being pushed. Note 
that a good way of erasing an unwanted line or some mistake is to 
“draw" over it with color <O>. Because zero is the background color, 
this will erase whatever is below the cursor. A related command, not 
explicitly shown in the text window, is <Z>oom. This command creates 
a greatly magnified picture of the region surrounding the cursor 
location at the time the <Z> key was pressed. One can draw on this 
magnified screen by positioning the cursor and pressing the fire 
button (¢ or the space bar ). The <Z>oom command is useful for drawing 
fine details. To leave the <Z>o00m mode, press the key for any other 
legal command. 


<Reectangle and <F>ill 


Other modes operate in a similar fashion. For example, in 
the <R>ectangle mode, one “marks" the two opposite corners of a 
rectangle with the cursors and the program will draw a box through 
the corners. The <F>ill command operates by filling in the screen 
along a horizontal line both to the right and to the left of the 
current cursor position until a color other than the current 
background color is reached. By holding down the fire button while 
moving the cursor, one can rapidly color-in large areas of the 
screen. ( Draw a rectangle and try to color the inside. ) 


f€E>llipses 


The <E>llipse command is used to draw elliptical shapes, of 
which the circle is a special case. To draw a Circle, first "mark" 
the center with one cursor and then move the other cursor out to a 
distance equal to the desired radius. Mark this location by pressing 
the fire button once again. A circle will then be drawn at the 
indicated location. 


To change the shape of the ellipse, press the <OPTION> 
button while in the <E>llipse command mode. A large green rectangle 
will appear with crossed vertical and horizontal orange lines. The 
relative lengths of these two lines represent the "aspect ratio" of 
any ellipse which will be drawn. When they are the same length, the 
result is a circle. You can use the joystick to shorten or lengthen 
the vertical line. Imagine an ellipse centered where the lines cross 
and just touching the ends of the lines. You can thus judge the shape 
for each vertical line height. Pick one. and then press the fire 
button ( or space bar ) = and you will be returned to the normal 
graphics mode. Now try drawing an ellipse again. The shape will be 
Circular only if the vertical and horizontal lines were the same 
length. ( Note that when the ellipses are highly elongated, the 
distance between the center cursor and the outer cursor is preserved 
only along the horizontal direction. ) 
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Changing <Croelors 


Now consider the <Crolors command. When you press the <C> 
key two vertical bars will appear. The bar on the left will display 
14 different colors, all at the same luminance, while the bar on the 
right shows the @ luminances that can be generated for each of the 16 
colors. The color value for the 8 luminances is indicated by an arrow 
Pointing to the left bar, while the luminance of the left bar is 
indicated by the arrow pointing to one part of the right bar. ( This 
description may sound a bit confusing to new Atari owners, but the 
Visual effects are straightforward. } The graphics mode being used 
can display 3 foreground colors against 1 background color. Each of 
these 4 colors can be set to one of the 128 combinations that are 
possible with 164 colors, each having 8 luminance possibilities. You 
are first asked to choose which of the 4 screen colors you wish to 
change. ¢ Remember that # 0 is the background color. ) Pick O as an 
example. Then use the <OPTION> and <SELECT> keys to move the arrows 
down the two color bars. The background of the screen will change 
color as these keys are pressed. When you obtain a color you like, 
Simply press the <START> key. You can then change one of the other 
color values, or quit by pressing <@>. The best way to understand this 
command is simply to play around with it and see all the color 
combinations possible with your Atari. ¢ Note that you can make 
Various parts of the display “disappear” by choosing certain colors 
that make text or drawings the same color as the background. If this 
causes confusion, simply hit the <SYSTEM RESET> key. ) 


Display Mades 


Now press the <ESC> key. The screen and text window will 
change colors, but other than that nothing too spectacular should 
happen. Press <ESC?> again and the screen will return to its initial 
configuration. The <ESC> key toggles the internal graphics display 
mode being used by the Atari but uses the same display data. The 
original mode is often called Graphics 7+. It is a 4 color mode not 
available with Atari Basic. It has twice the vertical resolution of 
Rasic’s graphics made 7 (thus 7+). Hitting the <ESC?> key once changes 
the display mode to Basic’s graphics mode 8. This display mode is 
described as a high resolution 1 color mode. A "trick" called 
“artifacting" makes it possible to produce several colors in this 
mode, however. ( See appendix with technical information. ) Being 
able to flip between these two types of display modes is primarily 
useful when small text is desired. This is further discussed later. 


Stave, <Gret, and <Perint 


The other commands are fairly obvious. <Srave and <Gret 
enable you to store and retrieve displays using your disk drive. Room 
for 8 screens has been alloted on the program disk. Each display is 
simply assigned a number as identification. The <Porint command 
enables you to print a copy of the display if you have an Epson 
printer with graphics capability. The printed output is available in 
two s§12Zes. 


One command not listed in the text window is <CTRL><CLEAR> 


or <SHIFT><CLEAR>. As you may have guessed, this clears the graphics 
screen. 
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<T>ext or Character Input 


Pressing the <T> key will shift you to the Text input mode. 
This mode is easily identified by the first line of the text window, 
which says: | 
TEXT INPUT Press <CTRL><@> to quit 


Try pressing the <CTRL><@> key. This should return you to the 
graphics mode previously discussed. Return to the text mode again by 
hitting the <T> key. You will notice the outline of a rectangle in 
the upper left hand corner of the screen. This is a cursor which 
indicates where the next character typed will be placed on the 
screen. Try typing a few letters. You may have noticed that the size 
of the letters is the same as that obtained in Basic Graphics mode 1. 
If you wish to change the text size or color you must first press the 
<TAB> key and then release it. The next key pressed is then 
recognized as a command rather than displayed on the screen. Press 
<TAB> followed by <1>,<2>, or <3> to get characters in colors 1, 2, 
or 3. Similarly, follow the <TAB> key with <S>, <M>, or <L> to get 
small, medium, or large characters. The cursor will change size when 
you give the <S>, <M>, or <L> commands. 


Moving the Text Cursor 


Cursor position can be controlled using various keys, such 
as <RETURN>, <BACK S>, and the 4 arrow keys (i.e. <CTRL><->, 
<CTRL><=>, <CTRL><+>, and <CTRL><&> ). Most keys operate in a manner 
Similar to their normal operation. You will notice, however, that the 
up and down arrows only move the cursor a small distance up or down. 
This distance is smaller than the height of a character. You thus 
have the freedom to type a character at almost any vertical location 
on the screen. ( This is very useful for subscripts or superscripts. ) 
If you wish to move the cursor up or down the screen more rapidly, try 
<CTRL><U> or <CTRLO<D>. 


The best way to learn about this mode of program operation 
is simply to play around with it for awhile. Note that you can also 
type lower case and inverse video characters as well as many of the 
special Atari characters. Be sure to shift back to the normal upper 
case letters before giving any commands. 


Optional Character Set 


By now you may have noticed the somewhat strange shape on 
the right hand side of the lower text window. This shape is the Greek 
letter alphas; it is) the first character of a special character set 
which can be modified to include whatever characters may be of 
interest. Press the <CTRLO<F> key to cycle forward through this 
character set. ( Use <CTRL><B> to go back to a character you may have 
passed. ) If you find one you wish to display on the screen, simply 
stop when that character is visible and move the cursor to the 
location where you want the character displayed. Then press the <P> 
key while holding down the <OPTION> button ( i.e. <OPTION><P> ). This 
will print the optional character. 


p& 


Special UCharacter Editor 


However, you may not find the special character you need, 
or you just may want to create some new characters or symbols. In 
this case, simply press the <OPTION> button and the <E> key 
Simultaneously ¢ <OFTION?<E> ) to enter the character editor. A green 
rectangular background will appear on the screen and an enlarged black 
layout of the current character ¢( i.e. the one currently being 
displayed at the right in the text window ) will be shown. A dark 
cursor will also be visible. You can move this cursor around the && 
grid of the enlarged character with the arrow keys. Pressing the space 
bar will "turn-an" a position that is "off", or “turn-off" a position 
that is presently "on". Each change is shown at the right of the text 
window. The entire character can be "cleared" by pressing 
<CTRLO<CLEAR>. When you get the special character you want, you can 
end the editing session by simply pressing the <E> key. The special 
character just created will be available with the other special 
characters until the computer is turned off. You can also permanently 
Save a special character by pressing the <CTRL><S> key while in the 
editing mode. This will replace the special characters which come with 
the program (which are stored on disk) by the ones you have created. 
( You may want to have different special symbol sets stored on 
different disks.) 


€@ WORD OF WARNING —- Some letters or characters may look 
very strange when entered as "small" characters. This is because the 
7+ graphics display mode does not have enough resolution to 
adequately handle the normal ATARI character set printed in the 
"snall" size. If you wish to enter small letters, press the 
<ESC> key to change the display mode to Basic graphics 8. This mode 
does have the resolution ta display the small letters properly. ( See 
Appendix A for a further discussion of display modes. ) 


Moving Text Around the Screen 


Finally, you may have a display you like, but some 
lettering is not centered or some piece is not quite in the desired 
location. In this case, you can use <CTRL><INSERT>, <CTRL><DELETE>, 
<GHIFT?><INGSERT?>, and <SHIFT><DELETE> to move things around on the 
screen. These commands work in a manner similar to their operation in 
a normal text mode, BUT THEY NOW OPERATE ON THE ENTIRE GRAPHICS 
DISFLAY. For example, <SHIFT><INSERT> inserts one extra scan line at 
the location of the top of the cursor. Try out these commands and you 
will quickly get an idea of how they operate. 


fROUBLE ‘2°? 


If you ever get in a situation where you do not know what 
to do, press <SYSTEM RESET>. This should just restart the program 
WITHOUT erasing the screen display. | 
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FROGRAM QRGANIZATION AND COMMAND SUMMARY 


Start 
* 
KXTEKKKERKERKEKKEKEK LCTRL?<Ttext EXKRKKKKAEKREREKAKKKSE 
x x x ‘ x 
¥ Sa eS SS See PD x 
% GRAPHICS MODE } § x TEXT MODE x 
bf 1S SSS SSS See eS x x 
% x x x 
KRXKKKAKAKEEKERKEKEEKKE <CTRL >< O>uit REKEKEKRERRRREKEEEKEK 
tbLeines ¢ rubber-band lines ) <BACK S?, <RETURN>?, 
<CLEAR?>, arrow keys, 
<ESllipse .CTRLS<INSERT>, and 
( Press <OPTION: to adjust <CTRL?< DELETE? all work 
shape of ellipse; press as ina narmal typing 
space bar when dane ) mode. 
Frill ~SHIFTS< INSERT? inserts 


one scan line 
“Rrectangle ( mark apposite corners } 
-SHIFT?<DELETE> deletes 


“Crolors ¢ change colors } one scan line 

20 gh 1 een oe e OF e352 <CTRL><U> moves cursor 
{ color numbers ) up 8 scan lines 

<ESC> ¢€ change display graphics >) <CTRLO<D?> moves cursor 


down 8 scan lines 
“Forint display 
( requires dot graphics ACTRLSAF> goes forward 
printer -see Appendix C 3} through special 
character set 
.GSeave display an disk 
<CTRL-AB>S goes back 


-Gret previously saved display through special 
fram disk character set 
2zCIRLS< CLEAR? or <SHIFT><CLEAR <TAB> first, then 
( clears screen } “212>,%27,¢3> for colors; 
257,.°M>,<¢L5> for text 
{Doraw ¢ when fire buttan size 


pressed ) 
LORTIONS<P?> to print print 


<fcacan  ( magnify displays special character 
fill pixel when 
fire button pressed; <OPTION?-<E> ta edit special 
any other command ta exit ) Character (use arrow 
<X> ( eXhibit screens: keys and space bar) 
ie "slide show"; <CTRL?><S> saves new 
press <RETURN?> when done character to disk; <E> 


ends editing 
LCTRLS<AT> € ga to text mode ) 
CCTRL?<Q> -— return to 
graphics mode 
ps8 


Appendix A 
ATARI HIGH RESOLUTION GRAPHICS DISPLAYS 


One of the most impressive capabilities of the Atari is the 
wide variety of graphics display modes. This versatility is made 
Possible by the use of a custom-designed microprocessor, called the 
ANTIC chip. ANTIC handlies the screen display, freeing the 6502 
microprocessor (and other chips) for other chores. In fact, the ANTIC 
chip even has its own program which tells it what kind of a screen 
display to generate. This program is called the display list. The 
ANTIC chip can actually display 6 types of character modes and 8 
graphics modes (not counting the GTIA modes) and these modes can be 
mixed in a variety of ways. Atari BASIC, however, gives the 
programmer direct access to only 9 of these modes ( called GRAPHICS 
Oo-8 in BASIC ). 


Graphics 8 is the highest resolution mode available. In 
this mode there are 320 picture elements or "pixels" in each 
horizontal line across the screen. There are 160 such scan lines when 
the text window is present at the bottom of the screen. Each pixel 
can either be "“on" or “off". OQne bit is thus required to tell the 
ANTIC chip whether or not to turn on the appropriate pixel. With 320 
pixels per scan line and 8 bits per byte, it is easily seen that 40 
bytes are required to describe each scan line. Each bit of any 
display memory byte is “mapped” directly into the pixels as shown in 
Figure A-1. 


In BASIC, the next highest resolution display mode is 
Graphics 7. Graphics 7 has 160 pixels per scan line and 80 scan lines 
from the top of the screen to the text window. The ANTIC chip will 
also support another display mode, often called graphics 7+. This 
mode is identical with Basic’s Graphics 7, except there are twice as 
many scan lines (i.e. 160 instead of 80 ). The vertical resolution 
is thus identical with Graphics 8. There are only half as many pixels 
in the horizontal direction, however, but each of these pixels can be 
given one of four colors ( as compared to 1 color in Graphics 8 ). To 
keep track of the assigned color for each pixel, two bits are 
required. The screen data for four pixels is thus stored in one byte 
(see Figure A-1) , and 40 bytes are therefore needed for one scan line 
of display data. Gnly half as many pixels are diplayed in Graphics 7+ 
as in Graphics &, but twice as many bits per pixel are required. This 
means that Graphics 7+ has the same memory requirements as Graphics 
8. The only difference is how the ANTIC chip displays the data. 


The same data can thus be displayed in Graphics 7+ or 8. 
One might expect the resulting displays to be quite different, 
however. This is true in many cases, but for some displays only the 
colors change when one flips from one display mode to another. This 
is due to an “accident"™ in color television performance called 
artifacting. 


Artifacting is due the inablity of a standard color 
television to accurately display the 320 pixels per line of Graphics 
8. The standard TV can display that many pixels but the apparent 
cOlor of each pixel depends upon the pixel’s location and whether or 
not nearby pixels are "on" or _“off". Thus a random line drawn in 
Graphics 8 may seem to consist of several colors. As indicated in 
Figure A-2, the apparent color of a section of the screen will depend 
upon the pixel’s location and whether the pixel next to it is also 
turned on. The actual colors seen depend upon the particular TV set. 
Note that the on-off bit patterns are similar to those that would 
appear in Graphics 7+ data (i.e. a (1 1) pattern indicates color # 3 in 
7+ and color A in Graphics 8 ). A little thought shows that 
multi-color images drawn in Graphics 7+ will also appear iin 
multicolors (¢ although different colors) in Graphics 8 due to 
artifacting. 


You can investigate this effect by drawing a multi-colored 
picture in graphics 7+ and the changing the display to graphics 8 by 
pressing <ESC>. Several colors will be seen. If you then press <Z>o0om 
to magnify the graphics 8 screen, only one color will be seen, but 
the alternating bit patterns shown in Figure A-2 will be apparent. 
Note that colors #1 and #2 will be printed in this alternating bit 
pattern form during a screen dump to the printer. 


Artifacting can cause some problems, however. As previously 
mentioned, a slanted line may appear to be made up of several colors. 
Also, artifacting can make certain characters very hard to read. ‘( Note 
that the Atari character set was carefully designed to minimize this 
problem by almost always having at least 2 horizontally adjacent 
pixels “on” in every scan line of every character. ) 


You can See these effects easily with the ALOG 
DISPLAYMAKER. First draw a few lines or circles in different colors in 
the 7+ mode. (The program starts out in this mode.) Then flip toa 
Graphics 8 by pressing the <ESC> key. Now draw some more lines or 
circles. The lines drawn in Graphics 8 have a finer resolution but 
are multicolored. You may thus want to use Graphics 7+ for displays 
where color uniformity is important. 


Unfortunately, Graphics 7+ does not have the resolution to 
display small text characters, such as those used in Basic’s Graphics 
oO. These characters are 8 pixels wide and 40 characters can be put on 
one line. It thus requires a resolution of 320 pixels per scan line 
to display these characters. This is achieved only in Graphics 8. 
Each byte of a character is mapped into only 4 pixels in Graphics 7+. 
The result is that small letters may look very stange in Graphics 7+. 
Note that the three colors of small text letters that can be typed 
with the ALOG DISPLAYMAKER are achieved by the use of artifacting. 
Some of these characters are distorted; this can be eliminated by 
changing to color <¢<3> before typing the character. Also, there is an 
upper case alphabet in the special character set that will look OK in 
Graphics 7+. Each character is only 4 Graphics 7+ pixels wide, 
however, sa that some characters are hard to distinguish. All of 
these effects make Graphics 7+ more useful for some things and 
Graphics 8 better for others. A good strategy in using the ALOG 
DISPLAYMAKER may be to use 7+ for making geometric drawings ( e.q. 
circles, lines, etc. ) and then change to Graphics 8 for adding small 
text. : 
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One additional difference between modes 7+ and 8 should be 
noted. Graphics mode 7+ is a true 4 color mode with the colors of 
each pixel determined by 4 color registers ( labeled 0-3 here with 0 
being the background color ). You must therefore change all four 
registers ( with the <Coolors command ) to completely change the 
colors seen on the screen. In Graphics 8, on the other hand, you can 
"see" four different colors, but they are not really independent. In 
fact, the colors seen on the screen are totally determined by only 
two color registers ( #2 and #3, as labeled here >). If you try 
changing colors while in the Graphics 8 mode you can rapidly get an 
idea af how these two registers control the color and luminance of 
the display. : 


Graphics 6 Graphics ?t 


Display Display 
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FIGURE &a-1 


ARTIFACTING IN GRAPHICS & 


11iiiiiii - Solid line ¢€ Color "aq 3} 

16161616 - Will “appear as solid 
line with artifact 
€ Color "5B" 3 

91616161 - Will “appear" as solid 
line with artifact 
€ Color "c™ } 
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APPENDIX E 


USING DISPLAYMAKER SCREENS AND CHARACTER SETS 
IN BASIC PROGRAMS 


The ALOG DISPLAYMAKER is written in a computer language 
called valFORIH, sold by Valpar International, 3801 E. 34th Street, 
Tucson, AZ 85713 (602 790-7141). This is a version of the very 
powerful FORTH language, enhanced to use the many special features of 
the Atari computer. FORTH is a very versatile language that runs much 
faster than BASIC, yet is quicker to program in than assembly 
language. One of the particular features used here is the direct 
reading and writing of disk sectors. Atari DOS is thus not used to 
store or retrieve any display screens. One can thus store more data on 
a disk, but such data cannot be read using normal DOS techniques. 


However, it is relatively easy to read data from a disk 
without using DOS. The attached BASIC program contains an assembly 
lanquage subroutine ¢ in the data statements ) which reads one sector 
from a disk in drive #1. Remember that there are 720 sectors and each 
sectar contains 128 bytes of data. | 


Fach screen stored by the ALOG DISPLAYMAKER occupies 50 
sectors of the disk. Screen #1 starts at sector #301, screen #2 at 
#251, etc. The BASIC program given here shows how to load this data 
directly into a Graphics 8 display. 


Note that this method of storing data does not use the 
"Yolume Table of Contents" normally stored on sector #360 by Atari 
bOS. In fact, screen #2 uses this sector for storage. Because Atari 
DOS looks at this sector when copying a disk, you may be unable toa 
copy an ALOG DISPLAYMAKER disk after you have stored a display at 
location #2. Your original program disk was initialized to avoid 
thas problem. You should avoid storing data on screen #2 of this disk 
so that you will not have problems in making copies. You can also 
re-initialize this sector to zeroes by simply storing a blank display 
in screen #2. 


You may also want to use a special character set (created 
with the character editor) in some other program. The 64 special 
characters are stored in sectors 71, 72, 73, and 74. Each character 
requires 8 bytes, so that 16 characters are stored in each sector. 
Character #1 is the one seen when the text mode is accessed for the 
first time. It is described by the first 8 bytes in sector 71. Other 
characters are sequentially stored. 


ot) 
340 
241 
342 
Su @) 
ool 
260) 
3/Q 
400 
1OO 
101 
102 
103 


EM KKKKKKEKEKKEKEKKEAKE KAKA KEK KEKE KEKE REA RKEKKKAREKEKKEREKERE 


EM xkxkxxk EXAMPLE OF HOW TO LOAD A SCREEN CREATED WITH THE ALOG 
EM KKKX | DISPLAYMAKER USING A BASIC PROGRAM 
EM *xkxxk 


EM kKxkxkx AN ASSEMBLY LANGUAGE SUBROUTINE ( CONTAINED IN DATA 


EM kKxkkKx STATEMENTS AND FUT IN A STRING ) IS GIVEN FOR READING 
EM KEK ONE SECTOR OF THE DISK AT A TIME 

EM kKxkxkx 

EM Kx USE IN THE FORM: 

REM xxx 


REM kkk X=USR( subroutine address, starting address of destination, 
REM xxx sector number) 
REM kkk | 

REM KXKKKEKKAEKKKKKKKKA KKK KEKE KEKE RK KEKE KKK KKKKEKEKKKKEKKKEKKEKKE 
REM xxx PUT ROUTINE TO READ A SECTOR IN THE STRING SECRDS xxx 
DIM SECRDS$ (36) 

FOR I=1 TO 36 

READ X 

SECRD# (I, 1) =CHRE (XxX) 

NEXT I 

REM kkk USE SCREEN # 1 AS EXAMPLE xxx 

GRAPHICS 8: SCRNUM=1 

START=FEEK (88) +256xPEEK (89) | | 
REM * START IS THE ADDRESS CORRESPONDING TO TOP LEFT CORNER OF THE 
REM GRAPHICS 8 SCREEN xk 

FOR I=o TO 49 

DESTADDR=START+1I £128 

REM * DESTADDR IS THE ADDRESS WHERE WE WANT THE 128 BYTES FROM 
REM SECTOR BEING READ TO START &. 

SECNUM=301+ (SCRNUM—1) 50+] 

REM x SECNUM IS THE NUMBER OF THE DISK SECTOR BEING READ x 

X=USR (ADR (SECRDS) , DESTADDR, SECNUM) 

NEXY I 

END 
© DATA 194,104,141,5,3,104,141,4,3,104 

O DATA 141,11,3,1904,141,19,3,169,1,141 
O DATA 1,3,169,82,141,2,3, 32,83, 228 

© DATA 173,3,3,133,212,96 


KXKX 
KKK 
KXxXx 
KKK 
Xxx 
Kx 
KXXx 
XXX 
KXXX 
KKK 
2 > S | 
KXKK 
KX 
KKKX 


APPENDIX C 


SENDING DISPLAYS TO A PRINTER 


ft is aften very useful to be able to make a printed copy 
of a screen display. The ALOG DISPLAYMAKER has the ability to print 
copies af the screen in two different sizes, using dot matrix 
printers with bit-plot graphics capabilities. Examples of § such 
printers include the EPSON (with graftrax) and the PROWRITER . Such 
printers operate by printing a dot if a certain bit is “on" or not 
printing the dot if the bit is "off". In general, 8 bits (1 byte) are 
sent to the printer at a time, so that 8 dots can be controlled. 
Ihese dots usually (if not always) correspond to 8 vertical print 
heads. A one dot wide column up to 8 dots high can thus be printed 
with one byte of data. Unfortunately, there are several different 
methods used to determine which print head is controlled by which bit 
and different printers use different control codes to tell them to 
enter a bit-plat graphics mode. 


Your original ALOG DISPLAYMAKER disk will print properly 
with an EPSON MX-80 printer with the Graftrax upgrade or a Gemini 10 
printer. If you hit the <P> key while in the graphics mode, you will 
be asked if you want a quick (small) print-out or a double size 
print-out. the small size print-out is 160 dots across the page 
and 320 dots vertically. It thus corresponds directly to the display 
screen turned 90 degrees (sa that the long axis of the screen 
corresponds to the long axis of a normal sheet of paper). The small 
screen dump plot will occupy about one-quarter of an 8 1/2 x 11 page. 
The double size print-out is simply twice as big. ( 320 x 640 ). It 
will approximately f111 one standard page on an EPSON MX-—8o. 


The ALOG ODISPLAYMAKER is designed so that the user can 
alter the printer control codes so that displays can be dumped on 
other printers. To alter the program, first enter the print section 
by pressing <F> while in the graphics mode. To change the control 
codes, then press <CTRL><C> instead of <RETURN> or <D>. You will then 
be asked ta enter various information needed by the program. 


You will first be asked whether the top print head (top 
dot) corresponds to the most significant bit (MSE) of the data byte. 
if your printer follows this convention, then a byte equal to 128 
would be printed as one dot with seven blanks below it. In some 
printers (such as the PROWRITER) the top dot is the least significant 
bit. A value of 128 would thus be printed as 7 blanks arranged 
vertically above a single dot. If you do not answer "Yes" ¢( <Y> ) to 
this question, the program assumes that the least significant bit 
corresponds to the top print head. Note also that some printers can 
be set to use only 7 of the 8 bits in a data byte. This program use 
all 8 bits and internal switches should be set appropriately. 


You will then be asked to "TYPE PRE-DUMP COMMANDS". Such 
commands ancilude any cammand needed ta prepare your printer for 
hit-plot graphics. One command almost certainly needed is the one to 
set the line teed spacing. You may also want to set the horizontal 
spacing between dots (i.e. dots per inch). Al] commands are entered 
am )06 String) 6 form, with each character printed representing one byte 
sent . to the printer. FPre-dump commands are sent before the actual 
screen dump process begins. You can enter up ta 36 commands. This 
command string should be terminated with at least one blank. Then hit 
SREVURN?: ta send the string to memory. 


For example, if you have a FPROWRITER, you can first set the 
Pitch to Fica (10 CFI) and then set the line spacing to 16/144 inches 
by haitting the keys ¢ Each CF J indicates a single character ) 


f <ESC> J C <N> 7 £ SESCs> J C =£T> J C 41> 9 C€ 6 J C “space bar? Jj 


You will then be asked ta “TYPE COMMANDS FOR 160 x 8 
FRINI". These are the commands necessary to print ane line of the 
shall screen dump (3.e. 160 columns, each 8 dots high). As previausly, 
commands are entered in string form and must end with a blank. Again 
using the PROWRITER as an example, one would enter 


FE <ESC?> 39 £€ <S> 3 € <0 9 £ <i> ] £€ «€6> J € <O> 7 C <space bar? J 


Finally, you must enter the commands to print 320 
bit-mapped graphics characters on one line when asked "TYPE COMMANDS 
FOR 320 x 8 PRINT". For the FPROWRITER, this is 


[ <ESC> 1 € <S> 7 € <O> J € <3> 2 € <2> JC o> aC <space bar> J | 


| Once these commands have been entered, they are stored on 
the program disk and will be loaded with the program. You thus need 
to customize the program to your specific printer only once. 


As previacusly mentioned, the ALOG DISPLAYMAKER program disk 
is initialized to use an Epson printer with the graftrax option. If 
you should ever change the printer contral codes and want to go back 
to the Epsan, the appropriate responses are: 


IS TOP DOT MSB ? [ <Y¥> ] 

(Y/N) 
IvFE FPRE-DUMP COMMANDS C<ESCOIL<APIL<CTRL><H>ll<space bar +] 
TYPE COMMANDS FOR 160 x 8 PRINT [<ESC>IC<K 3] 


r<Atari keyot space bar-<Atari key>] 
C<CTRL><, -if<space bar>)] 


{ Note that [<Atari key><space bar><Atari key?>] simply shifts the 
keyboard to inverse video, prints an inverse space,and then shifts 
back to the normal (non-inverse) display. Also (<CTRL><,>] just prints 
a heart. ) 


TYPE COMMANDS FOR 320 X 160 PRINT C<ESC>ILC<K>IC<SHIFT><8>) 
C<CTRL><A>i1C<space bar >] 


